{
 "cells": [
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": [
    "%matplotlib inline"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "\n",
    "# The mplot3d Toolkit\n",
    "\n",
    "\n",
    "Generating 3D plots using the mplot3d toolkit.\n",
    "\n",
    ".. currentmodule:: mpl_toolkits.mplot3d\n",
    "      :backlinks: none\n",
    "\n",
    "\n",
    "Getting started\n",
    "---------------\n",
    "3D Axes (of class `.Axes3D`) are created by passing the ``projection=\"3d\"``\n",
    "keyword argument to `.Figure.add_subplot`::\n",
    "\n",
    "   import matplotlib.pyplot as plt\n",
    "   fig = plt.figure()\n",
    "   ax = fig.add_subplot(111, projection='3d')\n",
    "\n",
    ".. versionchanged:: 1.0.0\n",
    "   Prior to Matplotlib 1.0.0, `.Axes3D` needed to be directly instantiated with\n",
    "   ``from mpl_toolkits.mplot3d import Axes3D; ax = Axes3D(fig)``.\n",
    "\n",
    ".. versionchanged:: 3.2.0\n",
    "   Prior to Matplotlib 3.2.0, it was necessary to explicitly import the\n",
    "   :mod:`mpl_toolkits.mplot3d` module to make the '3d' projection to\n",
    "   `.Figure.add_subplot`.\n",
    "\n",
    "See the `toolkit_mplot3d-faq` for more information about the mplot3d\n",
    "toolkit.\n",
    "\n",
    "\n",
    "Line plots\n",
    "====================\n",
    ".. automethod:: Axes3D.plot\n",
    "\n",
    ".. figure:: ../../gallery/mplot3d/images/sphx_glr_lines3d_001.png\n",
    "   :target: ../../gallery/mplot3d/lines3d.html\n",
    "   :align: center\n",
    "   :scale: 50\n",
    "\n",
    "   Lines3d\n",
    "\n",
    "\n",
    "Scatter plots\n",
    "=============\n",
    ".. automethod:: Axes3D.scatter\n",
    "\n",
    ".. figure:: ../../gallery/mplot3d/images/sphx_glr_scatter3d_001.png\n",
    "   :target: ../../gallery/mplot3d/scatter3d.html\n",
    "   :align: center\n",
    "   :scale: 50\n",
    "\n",
    "   Scatter3d\n",
    "\n",
    "\n",
    "Wireframe plots\n",
    "===============\n",
    ".. automethod:: Axes3D.plot_wireframe\n",
    "\n",
    ".. figure:: ../../gallery/mplot3d/images/sphx_glr_wire3d_001.png\n",
    "   :target: ../../gallery/mplot3d/wire3d.html\n",
    "   :align: center\n",
    "   :scale: 50\n",
    "\n",
    "   Wire3d\n",
    "\n",
    "\n",
    "Surface plots\n",
    "=============\n",
    ".. automethod:: Axes3D.plot_surface\n",
    "\n",
    ".. figure:: ../../gallery/mplot3d/images/sphx_glr_surface3d_001.png\n",
    "   :target: ../../gallery/mplot3d/surface3d.html\n",
    "   :align: center\n",
    "   :scale: 50\n",
    "\n",
    "   Surface3d\n",
    "\n",
    "   Surface3d 2\n",
    "\n",
    "   Surface3d 3\n",
    "\n",
    "\n",
    "Tri-Surface plots\n",
    "=================\n",
    ".. automethod:: Axes3D.plot_trisurf\n",
    "\n",
    ".. figure:: ../../gallery/mplot3d/images/sphx_glr_trisurf3d_001.png\n",
    "   :target: ../../gallery/mplot3d/trisurf3d.html\n",
    "   :align: center\n",
    "   :scale: 50\n",
    "\n",
    "   Trisurf3d\n",
    "\n",
    "\n",
    "\n",
    "Contour plots\n",
    "=============\n",
    ".. automethod:: Axes3D.contour\n",
    "\n",
    ".. figure:: ../../gallery/mplot3d/images/sphx_glr_contour3d_001.png\n",
    "   :target: ../../gallery/mplot3d/contour3d.html\n",
    "   :align: center\n",
    "   :scale: 50\n",
    "\n",
    "   Contour3d\n",
    "\n",
    "   Contour3d 2\n",
    "\n",
    "   Contour3d 3\n",
    "\n",
    "\n",
    "Filled contour plots\n",
    "====================\n",
    ".. automethod:: Axes3D.contourf\n",
    "\n",
    ".. figure:: ../../gallery/mplot3d/images/sphx_glr_contourf3d_001.png\n",
    "   :target: ../../gallery/mplot3d/contourf3d.html\n",
    "   :align: center\n",
    "   :scale: 50\n",
    "\n",
    "   Contourf3d\n",
    "\n",
    "   Contourf3d 2\n",
    "\n",
    ".. versionadded:: 1.1.0\n",
    "   The feature demoed in the second contourf3d example was enabled as a\n",
    "   result of a bugfix for version 1.1.0.\n",
    "\n",
    "\n",
    "Polygon plots\n",
    "====================\n",
    ".. automethod:: Axes3D.add_collection3d\n",
    "\n",
    ".. figure:: ../../gallery/mplot3d/images/sphx_glr_polys3d_001.png\n",
    "   :target: ../../gallery/mplot3d/polys3d.html\n",
    "   :align: center\n",
    "   :scale: 50\n",
    "\n",
    "   Polys3d\n",
    "\n",
    "\n",
    "Bar plots\n",
    "====================\n",
    ".. automethod:: Axes3D.bar\n",
    "\n",
    ".. figure:: ../../gallery/mplot3d/images/sphx_glr_bars3d_001.png\n",
    "   :target: ../../gallery/mplot3d/bars3d.html\n",
    "   :align: center\n",
    "   :scale: 50\n",
    "\n",
    "   Bars3d\n",
    "\n",
    "\n",
    "Quiver\n",
    "====================\n",
    ".. automethod:: Axes3D.quiver\n",
    "\n",
    ".. figure:: ../../gallery/mplot3d/images/sphx_glr_quiver3d_001.png\n",
    "   :target: ../../gallery/mplot3d/quiver3d.html\n",
    "   :align: center\n",
    "   :scale: 50\n",
    "\n",
    "   Quiver3d\n",
    "\n",
    "\n",
    "2D plots in 3D\n",
    "====================\n",
    ".. figure:: ../../gallery/mplot3d/images/sphx_glr_2dcollections3d_001.png\n",
    "   :target: ../../gallery/mplot3d/2dcollections3d.html\n",
    "   :align: center\n",
    "   :scale: 50\n",
    "\n",
    "   2dcollections3d\n",
    "\n",
    "\n",
    "Text\n",
    "====================\n",
    ".. automethod:: Axes3D.text\n",
    "\n",
    ".. figure:: ../../gallery/mplot3d/images/sphx_glr_text3d_001.png\n",
    "   :target: ../../gallery/mplot3d/text3d.html\n",
    "   :align: center\n",
    "   :scale: 50\n",
    "\n",
    "   Text3d\n",
    "\n",
    "\n",
    "Subplotting\n",
    "====================\n",
    "Having multiple 3D plots in a single figure is the same\n",
    "as it is for 2D plots. Also, you can have both 2D and 3D plots\n",
    "in the same figure.\n",
    "\n",
    ".. versionadded:: 1.0.0\n",
    "   Subplotting 3D plots was added in v1.0.0.  Earlier version can not\n",
    "   do this.\n",
    "\n",
    ".. figure:: ../../gallery/mplot3d/images/sphx_glr_subplot3d_001.png\n",
    "   :target: ../../gallery/mplot3d/subplot3d.html\n",
    "   :align: center\n",
    "   :scale: 50\n",
    "\n",
    "   Subplot3d\n",
    "\n",
    "   Mixed Subplots\n"
   ]
  }
 ],
 "metadata": {
  "kernelspec": {
   "display_name": "Python 3 (ipykernel)",
   "language": "python",
   "name": "python3"
  },
  "language_info": {
   "codemirror_mode": {
    "name": "ipython",
    "version": 3
   },
   "file_extension": ".py",
   "mimetype": "text/x-python",
   "name": "python",
   "nbconvert_exporter": "python",
   "pygments_lexer": "ipython3",
   "version": "3.8.6rc1"
  }
 },
 "nbformat": 4,
 "nbformat_minor": 1
}
